home *** CD-ROM | disk | FTP | other *** search
/ EnigmA Amiga Run 1995 October / EnigmA AMIGA RUN 01 (1995)(G.R. Edizioni)(IT)[!][issue 1995-10][Aminet 7].iso / Aminet / comm / mebbs / mtop120.lha / MTop.DOC < prev    next >
Text File  |  1994-07-05  |  7KB  |  184 lines
  1. ================================== MTop ===================================
  2. ===========================================================================
  3.                   A PostCard-Ware MEBBSNet-Utility written by
  4.              Brian Ipsen, © copyright 1994 by Brian Ipsen (#7001),
  5.                               All rights reserved.
  6.  
  7.  No  guarantee of any kind is given that the program described in this
  8. document is 100% reliable.  You are using this material on your own risk.
  9.  The author does not take any responsibility for the results of the use
  10. or misuse of this software.  The entire risk as to the results and
  11. performance of this software is assumed by the user.  The author is not
  12. responsible for any damage including loss of any data or information
  13. which may be lost or rendered inaccurate.
  14.  
  15.  MTop is a PostCard-Ware program (concept introduced by Klaus Seistrup,
  16. DK). If you like this program and use it regulary, you are obliged to send
  17. a postcard to the author. The address is at the bottom of this text-file.
  18.  
  19.  MTop may only be re-distributed on official MEBBSNet Support-BBS'.
  20.  
  21.  
  22. ===================== Updates & new program revision ======================
  23. ===========================================================================
  24.  
  25.  Whenever a new release of `MTop' becomes available, it will be uploaded
  26. at the Danish MEBBSNet Support-BBS, MicroAmiga BBS, 2:230/813.
  27.  
  28.  NOTE: If there's a program, that stores data via traplist.library, that
  29. you might want to get a Top-10 of, please let me know, and I'll try to
  30. see, if I can get it implemented in the next version.
  31.  
  32. ===================== Information about the program =======================
  33. ===========================================================================
  34.  
  35.  This program is made to create Top-10 bulletins for MEBBSNet.
  36. The original idea came from an utility to the AmiExpress system. I used
  37. the layout from the text-output and added some options... And here's the
  38. result.. 
  39.  The program needs a config-file. It should be called
  40.  
  41. MEBBSNet:Configfiles/MTop.cfg
  42.  
  43.  See example-configuration-file for more details.
  44.  
  45.  The program also needs the traplist.library if any of the FREQ/TICK
  46. options are used.
  47.  
  48.  Commandline options: CONFIG/K,NODELISTPATH/K
  49.  
  50.  CONFIG       :  Specifies alternative name of config-file
  51.  NODELISTPATH :  Specifies alternative path to nodelist in TrapList format
  52.  
  53.  
  54.  
  55. ======================== How to adjust the colors =========================
  56. ===========================================================================
  57.  
  58.  Here's an example of the output seen on the screen.... Here you can see
  59. where which color belongs... 
  60.  This screen-output might be slighty different from the one you get when
  61. you run MTop.
  62.  
  63.  
  64.             LineColor                  Datatextcolor  Username/Handle color
  65.                \/                                 \                    |
  66.         +--------------------------------------[   13] SOREN JENSEN ---+    
  67.         |   +----------------------------------[    9] KENNETH ANDERSEN       
  68.         |   |   +------------------------------[    8] JENS HANSEN
  69.         |   |   |   +--------------------------[    8] FRANK SOERENSEN
  70.         |   |   |   |   +----------------------[    5] ALLAN PEDERSEN
  71.         |   |   |   |   |   +------------------[    5] HENRI-ARNE PLOUG
  72.         |   |   |   |   |   |   +--------------[    4] STEEN MORTENSEN
  73.    14_| |   |   |   |   |   |   |   +----------[    4] BOERGE HANSEN
  74.       | |   |   |   |   |   |   |   |   +------[    3] MICHAEL PEDERSEN      
  75.    12_|###| |   |   |   |   |   |   |   |   +--[    3] TORBEN CHRISTENSEN
  76.       |###| |   |   |   |   |   |   |   |   |     
  77.    10_|###| |   |   |   |   |   |   |   |   |     
  78.       |###| |   |   |   |   |   |   |   |   |   TOP 10 MESSAGES        
  79.     8_|###|###| |   |   |   |   |   |   |   |   
  80.       |###|###|###|###| |   |   |   |   |   |   
  81.     6_|###|###|###|###| |   |   |   |   |   |   
  82.       |###|###|###|###| |   |   |   |   |   |   Created by MTop v0.99
  83.     4_|###|###|###|###|###|###| |   |   |   |       Made by B. Ipsen
  84.       |###|###|###|###|###|###|###|###| |   |   
  85.     2_|###|###|###|###|###|###|###|###|###|###| 
  86.       |###|###|###|###|###|###|###|###|###|###| 
  87.     0_|###|###|###|###|###|###|###|###|###|###| 
  88.     ^   ^
  89.     |   |
  90.     |   L__BarColor
  91.     L___DataTextColor
  92.  
  93.  
  94.  
  95. Colortable :
  96.  
  97.   0 : Black      1 :  Red       2 : Green      3 :  Yellow
  98.   4 : Blue       5 :  Magenta   6 : Cyan       7 :  White
  99.  
  100.  
  101. Outtype table:
  102.  
  103.   0: Plain ACSII
  104.   1: Animated ASCII
  105.   2: Animated with IBM-gfx-chars
  106.   3: With IBM-gfx-chars
  107.  
  108.  
  109. ===================== Acknowledgements/Thank you's ========================
  110. ===========================================================================
  111.  
  112.  TrapDoor, TrapList, traplist.library are (C) by Maximilian Hantsch &
  113.  Martin Laubach
  114.  
  115.  MEBBSNet is (C) by MEBBS E. & S.
  116.  
  117.  FServ is (C) by Mark Cassidy
  118.  
  119.  
  120. ========================== History/Highlights =============================
  121. ===========================================================================
  122.  
  123. Changes:
  124. ========
  125.  
  126.    V1.20 - Added EXCLUDEMASK statement.
  127.  
  128.    V1.14 - Some error-codes changed to use PrintFault instead of Printf.
  129.  
  130.    V1.13 - Now uses utility.library to do some of the math-stuff.
  131.  
  132.    V1.12 - Bug fixed in code, which generated the bars in Ascii/Ibm-mode.
  133.  
  134.    V1.11 - Cleaned up code. 
  135.  
  136.    V1.10 - Major changes in code, which resulted in a program approx.
  137.            10 KB smaller.
  138.            File I/O now done direct with dos-routines instead of standard
  139.            C-routines.
  140.  
  141.    V1.06 - Fixed the added code from v1.05, it didn't work probably.
  142.            Small changes/adjustments done to text-output.
  143.  
  144.    V1.05 - If a user had more than 100000 KB up/down-load, the output
  145.            would get corrupted. Tried to fix bug. Not released for
  146.            public use.
  147.  
  148.    V1.04 - If Tick-output file was not specified, program would report
  149.            error or breakdown. Bug fixed.
  150.  
  151.    V1.03 - Added developer-number to output-files.
  152.  
  153.    V1.02 - Added text output, so user can see what MTop is doing.
  154.  
  155.    V1.01 - Added check for output-files, so traplist.library not will be
  156.            needed, unless TICK/FREQ-top tens are created.
  157.  
  158.    V1.00 - First official release, converted from StarNet
  159.  
  160.  
  161. ========================= Words from the Author ===========================
  162. ===========================================================================
  163.  
  164.  Greetings, questions, bug-reports, gifts, $$$ and Postcards should be
  165. sent to:
  166.  
  167.   GizmoSoft Productions
  168.   c/o Brian Ipsen
  169.   Lyngens Kvarter 274
  170.   DK-7400 Herning
  171.   Denmark.
  172.  
  173.  Electronic mail: 2:230/813.97@FidoNet
  174.                   39:140/111.97@AmigaNet
  175.  
  176. Flames -> NIL: !!!!
  177.  
  178.  Thanks goes to Carsten Lohmann for suggesting me to write this program, and,
  179. of course, to the coders of the original program (I used their layout).
  180.  
  181. **********************************
  182. *** EOD - End of Documentation ***
  183. **********************************
  184.